package com.ruoyi.topic.service;

import java.io.IOException;
import java.util.List;
import com.ruoyi.topic.domain.HsTopic;

/**
 * 热搜主题Service接口
 * 
 * @author lzk
 * @date 2025-06-17
 */
public interface IHsTopicService 
{
    /**
     * 查询热搜主题
     * 
     * @param id 热搜主题主键
     * @return 热搜主题
     */
    public HsTopic selectHsTopicById(Long id);

    /**
     * 查询热搜主题列表
     * 
     * @param hsTopic 热搜主题
     * @return 热搜主题集合
     */
    public List<HsTopic> selectHsTopicList(HsTopic hsTopic);

    /**
     * 新增热搜主题
     * 
     * @param hsTopic 热搜主题
     * @return 结果
     */
    public int insertHsTopic(HsTopic hsTopic);

    /**
     * 修改热搜主题
     * 
     * @param hsTopic 热搜主题
     * @return 结果
     */
    public int updateHsTopic(HsTopic hsTopic);

    /**
     * 批量删除热搜主题
     * 
     * @param ids 需要删除的热搜主题主键集合
     * @return 结果
     */
    public int deleteHsTopicByIds(Long[] ids);

    /**
     * 删除热搜主题信息
     * 
     * @param id 热搜主题主键
     * @return 结果
     */
    public int deleteHsTopicById(Long id);

    /**
     * 清理并导出相关链接
     *
     * @param period 清理周期（天）
     * @throws Exception 异常
     */
    void cleanAndExport(Integer period) throws Exception;

    /**
     * 导出数据到CSV文件
     *
     * @param data 数据列表
     * @param dirPath 文件保存目录
     * @param tableName 表名
     * @throws IOException 异常
     */
    <T> void exportToCsv(List<T> data, String dirPath, String tableName) throws IOException;
}
